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INSTALLATION 



From Disk! 



DPut the product disk into drive 0, 

2)Press the RESET button, i.e. BOOT the system. 

3)The COPYRIGHT notice will appear. If this fails, check that you are using the correct disk 
for your system - Mod I (including Video Genie) or Mod III. 

4>A menu will also be displayed: 

"D" selects the Disk-Overlay version of the Editor. 
"I" selects the In-Core version. 

5)For the in-core version you will be prompted to supply a relocation address. Allow 3534 
bytes from the top of your memory. Alternatively, ENTER alone will automatically relocate 
to the highest address suitable for your system (and will use slightly less than 3534 bytes). 

6)Remove the product disk and replace it by your own system disk. Use a TRSDOS disk for 
pref grgn C5t The installation Process will work on some other DOS's, but not all. You can 
CONVERT or COPY the installed file from TRSDOS to another DOS, if used. 

7>Press ENTER. (Do not REBOOT!) 

3)The system will now appear to REBOOT, If you have an AUTO command in effect, this will 
be displayed on the screen but it will NOT have been executed. 

?)For the Disk-Overlay version you will now be prompted to reinsert the product disk, and 
then the system disk. For the In-Core version, a DUMP command will be displayed, If either 
of these fail to appear on your system, then use TRSDOS. 

10)The end result of this sequence will be to place a file called EDIT/CMD on your system 
disk, Use this copy directly, or COPY it to a data disk, or another DOS, if necessary, 

The Disk-Overlay version is the easier to use, but it will run only on TRSDOS, LDOS, or 
smal-LDOS, The In-Core version of the Editor runs permanently in memory, and in 
consequence is faster to invoke than the overlay version. It will run on all DOS'es, or even 
on Level2, However you must provide adequate space for it in PROTECTED memory. The 
installation process will ask you to enter the address at which you want the Editor to run, 
When y D u enter Disk BASIC you must set MEMORY SIZE to this value (or lower if you have 
ether programs in protected memory), For the Disk-Overlay version, just enter Disk BASIC 
in the normal way, 

To use either version type 

CMD U I U ,"EDIT" 

when in Disk BASIC, This loads EDIT into memory and branches to its first location, 

"activating" it, For the Disk-Overlay version it also enters full-screen edit mode. For a 

subsequent invocation of the Disk-Overlay version, or for the first invocation of the 
In-Core version, type /EDIT, 




From Taoet 

Refer to the separate sheet, RELOC, for instructions on loading and relocating the tape 
supplied, You need to allocate 33S4 bytes of memory in protected storage for the Editor* If 
you have no other machine code programs in protected memory then answer the "MEMORY 
SIZE?" question as follows: 



Machine Siie 


MEMORY SIZE answer 


16K 


29184 


32K 


45563 


48K 


61952 



Use LEVEL II (not Disk BASIC) to load the tape initially, and to relocate the Editor to the 
appropriate target address for your machine, Then you can dump a 3534-byte core-image fii* 
either on tape (using TEUG, or Southern Software's TSAVE) or on disk using the TRSDOS 
DTJMP command* If you load the Editor directly from this dumped copy in the future, 
remember to leave enough protected memory for it under LEVEL II or DOS, 

To use the Editor you must first activate it by branching to its first location! 



SYSTEH (enter) 
*? /3S333 (enter) 
READY 



where 33333 is your chosen st3rtir«3 address of the Editor 



From now on the Editor can be invoked by the command; 

./EDIT 

cautions: 

1) The Editor uses a variable amount of stack space during editinq, as a buffer to hold the 
currently modified line, and as workspace, This can be as much as 500-600 bvtes, So a 
program that only just fits in unprotected memory may cause an OM (Cut-of-Memory) when 

edited, 

2) When you modify a program all EASIC variables are cleared and all files are closed* If you 
use EDIT to examine a program compiled under one of the ACCELs, clearing the variables in 
this way will mean the program will no longer run unless recompiled, 

3) For NEWDOSS0 or DOSFLUS precede the /EDIT by a blank, 




'// 



FUNCTIONS PROVIDED BY THE EDITOR. 

The rest of this documentation applies to all versions of the Editor* After the special 
initial load and activation, you invoke the program in all cases by* 

/EDIT or /EDIT nnnn or /EDIT. 

where nnnn is a line number, (-." stands for "current line number"), For the Disk-Overlay 
version you can also use nnnn or • on the initial command, e.g. CMD'TVEDIT 330", 

F ° r ^ e l n ~ CDr - version y° u ™st NOT destroy the Editor in storage while it is activated - 
else BASIC will fail. You can deactivate it by branching to its starting address a second 
time. If you leave BASIC (using CMD"S") while the Editor is activated (or deactivated), you 
2TJ2Sr ter BASIC and reactivate "» without reloading it, However, be aware that the 
SYSTEM command does not work on Model III under Disk BASIC, Use DEFUSR instead. 

Activation enables the /EDIT command, using the "trap" at address HEX'41B3', Other 

pr0gr !^JJl a I ™ * h * s T trap and thereby destr °y the activation, so that /EDIT is diagnosed 
ff ^ , I ERROR. In this case reactivate by branching to the first location aaain. For 
the Disk-Overlay version, re-execute CMD"I","EDIT", Note that use of ACCEL4 will alwavs 
deactivate the Editor under smal-LDOS, and sometimes also under TRSDQS or LD03, 

The Display Format 

After ycu use the /EDIT command you will see 15 lines of your program, startina from the 
one you specified on the /EDIT command, or at the beginning of the orooram if you did not 
specify a line number, The left hand column and right hand column normally contain a 
vertical bar, The bar is broken to show you where program lines spill over into more than 
one line on the screen. The bar at the end of the line kinks to show you when vou have 
changed a line, The bar at the left hand end of a line will be chanced bv the Editor to a 
different - flashing - character to remind you about things you have done to the line, 

The bottom line of the screen is used for messages and commands, 
The Cursor 

At one place on the screen there will be a flashing blob, This is the full-screen cursor. You 
can see the character that is under the cursor as it flashes. Normally when you press a key 
die keyed character is placed where the cursor is (replacing the character that was there). 
The cursor then moves onto the next position. This is the normal way to change characters, 

J K he l° Ur i rr ° W keyS ° n thS TRS ~ 80 kE? y board 5nable y°u to move the cursor without changing 
the characters that the cursor moves over. The cursor moves one step in the direction of the 
arrow each time you press the key, Like all other keys, if you hold an arrow key down for a 
second or so the function of the arrow will be repeated quickly until you release the key, 
This means you can move the cursor all over the screen easily. So you use the arrow keys to 
move the cursor to the characters that you want to change, 

You can do this even if you cannot see the line you want to change - to get to later lines of 
your program, ycu move the cursor down towards the bottom of the screen and keep going! 
The Editor will automatically bring the later lines of your program into view. Similarly, to 
see earlier program lines you try to move the cursor off the top of the screen and the lines 
automatically come into view. This is called "automatic scrolling", 



Special Ksvs - "BREAK-. "^TT t r", "CLEAR". Arrows ^u , lra ,. 



^^f^^P* 8 . y °Vi nt ° a Specia: CDmmand mode ' ^ commands are described below 
oacTinto iS* tW1C9 <that " PreSSin9 BHEAE Whe " in Speaal ™- d modefpltl^o" 

this c^«Tth™T ^1 Chan9eS ' T0U preSS " CLEAR " if y° u have Ranged your mind - 
this causes the operation to be cancelled. Most commands also have the effort of -v^L« 
on operations that have not vet been completed, as does automatic scrolling ^^ 

l^Zy^Z crCThe arr™ 5 "' "/° U "^V ™ k ^ WhiIe h ° ld "9 down the 

special ml'an^^h^L^Tliel o" t'e" a^f^s" fcaSf ^ TT "" 

SHIFT/arrow (delate line. 32-char Hicn J n r y backspace, tab, newline) or to 

Program, but itt show: "as a down ato^ ™ "* ^ * ""^ ^ plMd * th * 

L hB 3, tey haS a 5qed5i meanin S to the Editor, If you wish to tvoe a oUin ««» fh«, „ 
the "0" (zero) key while holding down the SHIFT key/ P @ *" pre3S 

The g Control ITpv 

Editor us^f th" ^S'iKwVl^?^ *"* ^^ "» ^^ *«»« S ^ C 
the same time, When^ed £t^ T "* key ^ U P ress * 

this document »Q/X» means hold down the W w^nrf^ -control- key. In the rest of 

means noic aown the Q key and then press the "X" (for example). 

Extended Cursor Control TT?vg 
"Q" with numeric keys help you do more things with the cursor} 
@/l - makes the cursor jump back to the beginning of the current line, 
0/2 - makes the cursor jump to the beginning of the next line 

^» 1 ztrc h raK! , keyboards without them - you 

«/4 I Is the s™ as ^'TZ^T' *"** 1' " TOVeS the eurM ' down ° ne ""e. 

@/5 - s the san^e as "-"-' hff > m ° VeS ** DJrSOr °" e Charact * r to the !•«• 
ra/i ^ ' ' that 1S at moves th e cursor one character to the rinM- 

0/4 - » the same as the up-arrow! that is it moves the curso^Tone line § 

Q/7 - lets you insert characters. 

SS m^^hT^ r arV fn^en ' £2 "he ne^T™ ^ ""* ™ ° f the ««« " 

and you return ^normal ^r^^o^X^^.^' S/7 the T ^™* 

^or^C^^S^^o*^ ^ pe d °?f " 0t replaC5 thB charart - a * the 
to mak- roon for thp n-w 1= Z 9 ^ aractsr and *" tha re *t of the line are moved up 

to ma*, room for the new character - so the new character is inserted into the line. 

ro fm ^«. Char * CtBr ^^ " * thS ajrS ° r P0Siti ° n and ™ ves th * «* of the line bac* 
0/? deletes the rest of the line starting from the cursor position. ' 




Ling Commands 

"Q" with a letter is used mainly for commands that operate on whole lines* The Une that is 
affected is the one containing the cursor, 

Q/L means lock, and is a Shift Lock which switches you from upper case only to upper/lower 
case, or back again. To ensure a valid BASIC program, lower case characters persist only 
inside .quoted strings or remarks, 

Deleting Lines, 

Q/D deletes the line containing the cursor, Actually it just causes a "D" to flash at the i»ft 
hand end of the line, When you next press "ENTER" the line will be deleted, This is a 
special feature to enable you to change your mind, If you decide not to delete the line (for 
example, because you selected the wrong line) press "CLEAR" instead of EHTER. 

You can also delete a line just by deleting all the characters of the line, If a line is blank 
delTteT ^ "^^ ^ "* """ 0nly ™ tainS * UnS nUmber) the ^e is ^omaticSy 

Splitting and Joining Lings, 

nnH JficT Plit thS ^ r ? nt ,\ ine int ° tW ° line5 ' at the ^^ P° si *i°n, deleting the character 
under the cursor, which will normally be a "V statement divider. 

©AT will join the line identified by the cursor with the line below, inserting a »:» between 



them, 



Creating New Lines, 

The Editor lets you create lines in several different ways - to save typing, But you should 
be careful how you create line numbers. When the Editor creates a line, it may have the 
same number as an existing line and/or its number is out of sequence with the lines before 

Whtn t 1 h 1S 4. B ! Sen , tial t0 * Uow y ° U t0 9St the benefit Df c °Py in 9 ^ moving lines, 

vmT V Z ^ ^ 6 a hne With a line number that normal SASIC "°uM not allow the 
Editor flashes a $" character at the left hand end of the line, You should change the line 
number to a valid one by overtyping the existing one, 

ct^no"^^ l A ! IC WhilS therB iS *" invalid line number in y°^ Program you may get 

*J a ir 9 rn t ' ^ V ° U mU n0t ha ™ y0ur pr °9 ram * Go b ^ to the Southern Soft wire 

nn.lfi r , tPt >^ eCt the err ° n Y ° U Can even save ^ d rei0 * d 5uch * P^gram in the 
normal format but MOT with the ASCII option. x 

The Editor does not duplicate the function of AUTO, and where you have many new lines to 

add ° r T^"n S m y ° Ur pro 9 ram > y° u m ^/ ^d it more convenient to exit from the Editor and 
use AUiOi 

@/I inserts a new line after the line containing the cursor, If you dont type anything into 
the new line before the next time you press "ENTER" the new line will disaooear again. You 

W nd US nn 1 Ik ^t * **"* at the t0p ° f y0ur W™ " U5B ® /R tQ ™«t the too line 
une and update the first version of it, 

?51J7f h v atBS ^1^7**1 lin6f That is " creates ^ e3cact c °Py ° f ^e line immediately 
atter it, You use this function to save typing when you need to create a similar line, 



@/C cooies a line to a specified position. After you press Q/C a "C" will flash at th= i=«. 
hand end of the line that contained the cursor. You then move the cursor to the oroar^, Hn= 
where you want the copy of the line placed. Then press @/A if ^ * ant "h^cooyTlac^d 
"after" the line with the cursor, or ffl/B if you want it placed "befor^the line witn th= 
c^ S ev r en T uTdatTlinlstn ^" ^^ "**""" '"»*"»"» ™ and'th^or <?£ Y u* 
wTer^out^the^of th^L!" ^ "" "*" "" """*" ^^ <See Uler) t0 *« y °" 

I h ! n ^ S t U h! ? f * hS co h py c = mmand ^ an exact copy of the original line. You will always have to 
change the line number of the new line or the original. y 

^^L" 1 ™*^^*^™' T ° U U3e @/M with @/A or @ /3 t0 ^ow where the line is 
i.o be moved to - just like Q/C\ 

Q/P positions the line according to its line number. @/P is an alternative way to move or 
TrZlt *h 5 "' ° f CSDylnS ° r m ° Vin 9 a line «" d then ch *nging « and/or its line number 

The ^L%heVmo i vedt er ; °' ""if" "^^ ° f a ^ "^ * @/R *" d the" use |/P 
givtnlt. C ° rr se <* uentiaI P 1 ** according to the line number you have 

Block Commands 
hl'ln^r 1 k^ ^T^' The line cant aihing the cursor when you press 0/Q is the 

t^ th^whole bS S "iL^ -n^v a y f ° r * linE C ° mmand ' The 1Lne CDmman ° then applies 
whole bloct! of lines! '"^ ^ =" *** m ° VS ' rS?liCate ' dslet3 ' *"< ?«**«> 

Also note? 

If you change your mind about the beginning of the block, just repeat the @/Q command. 

Ycu «n specify the end of the block as a line that is before the beginning, The effect is the 

Tcu can use the "find" command to get you to where you want the end of the block to be, 
Block delete happens immediately you press @/D (unlike line delete). 




Special Commands 
lil^vZ™ "SEEAE" when in normal mode, you can type a special command in the command 

rlfof 5 a;^TpTo y g ^ dal C ° mmand ' ^^ thS *"" " d «*"- * BASIC. No. you can 

rf^ " execute the 5 P ecial command and return to normal mode. 

CLEAR - you have changed your mind, Return to normal mode ignorino anv SDeH^i nmma nH 
(If vour kevhnAt-rt rinoc nn* h-w« .. /*t t? a -^ , m,uu C lynuruiL, any special command* 

your xeyDoard does not have a CLEAR key you can use @K as an alternative.) 

^TJThT 1 " 9 a 5PBCi f commarid y° u can use the normal cursor functions (arrows and S/7 
8, 9) to help you correct mistakes in the special command. The Special Commands are! 

nnnnn where nnnnn is a number between and 45520. 

^i 5 h=r 0S it i< ; n s S T ? iS ? l t Y S ° that at the middle of ttle scrBen i» the statement with this 
number, or the first statement after the number if there is no exact match, f 'wticulZ 



Fdxxx...d 



where xxx... stands for up to eight characters, and d is any chosen delimiter. 



This means find the first occurrence of the charact=rs -rr =*•»,•*„„ r„~ t 

was when "3EEA7T" w-e „„.«„,< tti. ™aracr_r=^xx.., smarting from where the cursor 

sucn oc^rron- Th» 4=-! !, , h f" X ° U prBSS EKTER the a - TSDr is ^ed to the first 
l"^J XT ' Th f , traillng dellm ^r may be omitted unless you want to search for I 
Slr V 9 p^r TD ; , ; alll^ i„"i T : kS • ^P 1 ^ <* ««reh strings are! X ""* f ° r * 

Th=\f^ ^RETURN- FTffiTTOH F HEAD A F/A=B / (includes blanks) 

P re=s @/T ,o repeat the find using the same string of characters. 

Gdyyy...d where yyy... stands for up to eight characters, and d is any delimiter. 

™"*Sn^,d)"St^?n?T Be " . C K mmand ' Whe " y0U press ENTER the «"* «••• <»* by 
tne tina command) starting fmrn the current cursor position is reolaced bv vw vZ 

o v ^ n^l. hVT-^ P s r o 5 e S 4L n9 c e/G ' T H^ if ?? WUh tD ^ *" o^rrencTs of^ 

5^ ^C d ° Wn thE @/G ^^ • thS Edit ° r ^ — ^ ^prog^ 

To change just some of the occurrences of xxx to vv vou u?p ¥h* cam* e«=«,i • ■ ^ 

then nrpcc q/t f n «„w ,„ „ ,. yy y u U5e rne sam e speaal commanas Dut 

r ; /F tD fx ™? *" occurrence of xxx, then press Q/G only if you want to change thi= 

occurrence to yy, and then press @/F to go on to the next one. 9 

Sm°^Z S .f * string, find it using «F «„.» and then change it to nothing 
u=,ing ,he G command without any string. Hold Q/G down to delete further occurrences. 

Smmind^ '^* Jl3 "l". in a nUmber of P l£ce * 5et the ^d string to null using th= 
command F without a string, position the cursor to where you want the strinc Ssert-d 
first, and use f he command H n -rw » tk^ .--n • ^ ^^ ' e = ,trin S msenea 

Dr , itnp + JT", CDmn ;and g xx^... . This will insert the xxx... at the cursor position. Then 
position the cursor to the next place and press @/G, etc. P°=iuon. i nen 




Summary of Functions 



Invocation 



Special Keys 



/'EDIT 

/EDIT nnririri 
/EDIT , 

BREAK 

ENTER 

CLEAR 

Arrow keys 

SHIFT/0 

SKCFT/arrow 



Control Ccnwands 



Notes,' 



0/D 
0/1 
0/R 
0/C 

3/A 

a/e 

0/P 
8/Q 
8/F 

0/G 
8/L 
3/S 

0/J 
e = automatic "ENTER", b 



be 
e 
eb 

be 

be 
e 
e 
eb 
e c 
e 
e 

c 
e 
e 



invoke Editor at start of progra* 

invoke Editor at line nmnn (or next line) 

invoke Editor at "current" line 

enter special connand node, (twice = return to BASIC) 

comit operation and updates, reset nodes 

reset changes since last "BiTER" function, cancel operation 

rove cursor one character in the direction of the arrow 

types the nomal "@" character 

types the nornal arrow character 

delete line or block of lines 

insert new line 

replicate lire or block of lines 

copy line or block of lines 

we line or block of lines 

after here (use with 0/C and 0/M) 

before here (use with 0/C and 8/H) 

position line or block of lines 

start of block comand 

repeat find operation 

global change operation 

change shift lock 

split line in two 

join two lines to one 



Special Co/wands 



Cursor Ccwtancs 



nnnnn 

F >ccccccc< 

G yyyyyyyy 



8 block cofwand (with @/Q), c = clear will cancel. 

display statement rmnnn 

find next occurrence of xxxxxxxx 

change xxxxxxxx to yyyyyyyy 



The following table is arranged like the keys on a TRS-SO numeric keypad: 



* 7 x 8 x 9 x 
x insert x delete x erase x 

* node i char x rest x 
JMXxxxxxxxxxxxxxxoxzxxrxxxxxx 

* * * 5 x 6 x 
1 <~ x — ■> X up x 
x * x x 
"^axxxxxxxxxxxixxxxjxxxxxxxx 
1 1 x 2 i 3 x 

* start x next x down x 

* of line x line x x 

PXXXXXIXXXXXXXXXXllXmxxXYTTT 



to be caused by its use, re - pGnsiblllt >' ls «°»Pted ror any loss or damaae caused or alieaed 




'/ 



